home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglbegin.z / fglbegin
Encoding:
Text File  |  2002-10-03  |  14.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ffffggggllllBBBBeeeeggggiiiinnnn((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ffffggggllllBBBBeeeeggggiiiinnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllBBBBeeeeggggiiiinnnn,,,, ffffggggllllEEEEnnnndddd - delimit the vertices of a primitive or a group of like
  10.      primitives
  11.  
  12.  
  13. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      SUBROUTINE ffffggggllllBBBBeeeeggggiiiinnnn( INTEGER*4 _m_o_d_e )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _m_o_d_e  Specifies the primitive or primitives that will be created from
  19.            vertices presented between ffffggggllllBBBBeeeeggggiiiinnnn and the subsequent ffffggggllllEEEEnnnndddd.  Ten
  20.            symbolic constants are accepted:  GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS, GGGGLLLL____LLLLIIIINNNNEEEESSSS,
  21.            GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP,
  22.            GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN, GGGGLLLL____QQQQUUUUAAAADDDDSSSS, GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP, and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN.
  23.  
  24. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  25.      SUBROUTINE ffffggggllllEEEEnnnndddd( )
  26.  
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ffffggggllllBBBBeeeeggggiiiinnnn and ffffggggllllEEEEnnnndddd delimit the vertices that define a primitive or a
  30.      group of like primitives.  ffffggggllllBBBBeeeeggggiiiinnnn accepts a single argument that
  31.      specifies in which of ten ways the vertices are interpreted.  Taking n as
  32.      an integer count starting at one, and N as the total number of vertices
  33.      specified, the interpretations are as follows:
  34.  
  35.      GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS              Treats each vertex as a single point.  Vertex n
  36.                             defines point n.  N points are drawn.
  37.  
  38.      GGGGLLLL____LLLLIIIINNNNEEEESSSS               Treats each pair of vertices as an independent
  39.                             line segment.  Vertices 2n-1 and 2n define line n.
  40.                             N/2 lines are drawn.
  41.  
  42.      GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP          Draws a connected group of line segments from the
  43.                             first vertex to the last.  Vertices n and n + 1
  44.                             define line n.  N-1 lines are drawn.
  45.  
  46.      GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP           Draws a connected group of line segments from the
  47.                             first vertex to the last, then back to the first.
  48.                             Vertices n and n + 1 define line n.  The last
  49.                             line, however, is defined by vertices N and 1.  N
  50.                             lines are drawn.
  51.  
  52.      GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS           Treats each triplet of vertices as an independent
  53.                             triangle.  Vertices 3n-2, 3n-1, and 3n define
  54.                             triangle n.  N/3 triangles are drawn.
  55.  
  56.      GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP      Draws a connected group of triangles.  One
  57.                             triangle is defined for each vertex presented
  58.                             after the first two vertices.  For odd n, vertices
  59.                             n, n + 1, and n + 2 define triangle n.  For even
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllBBBBeeeeggggiiiinnnn((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ffffggggllllBBBBeeeeggggiiiinnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.                             n, vertices n + 1, n, and n + 2 define triangle n.
  75.                             N-2 triangles are drawn.
  76.  
  77.      GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN        Draws a connected group of triangles.  One
  78.                             triangle is defined for each vertex presented
  79.                             after the first two vertices.  Vertices 1, n + 1,
  80.                             and n + 2 define triangle n.  N-2 triangles are
  81.                             drawn.
  82.  
  83.      GGGGLLLL____QQQQUUUUAAAADDDDSSSS               Treats each group of four vertices as an
  84.                             independent quadrilateral.  Vertices 4n-3, 4n-2,
  85.                             4n-1, and 4n define quadrilateral n.  N/4
  86.                             quadrilaterals are drawn.
  87.  
  88.      GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP          Draws a connected group of quadrilaterals.  One
  89.                             quadrilateral is defined for each pair of vertices
  90.                             presented after the first pair.  Vertices 2n-1,
  91.                             2n, 2n + 2, and 2n + 1 define quadrilateral n.
  92.                             N/2-1 quadrilaterals are drawn.  Note that the
  93.                             order in which vertices are used to construct a
  94.                             quadrilateral from strip data is different from
  95.                             that used with independent data.
  96.  
  97.      GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN             Draws a single, convex polygon.  Vertices 1
  98.                             through N define this polygon.
  99.  
  100.      Only a subset of GL commands can be used between ffffggggllllBBBBeeeeggggiiiinnnn and ffffggggllllEEEEnnnndddd.
  101.      The commands are ffffggggllllVVVVeeeerrrrtttteeeexxxx, ffffggggllllCCCCoooolllloooorrrr, ffffggggllllIIIInnnnddddeeeexxxx, ffffggggllllNNNNoooorrrrmmmmaaaallll, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd,
  102.      ffffggggllllEEEEvvvvaaaallllCCCCoooooooorrrrdddd, ffffggggllllEEEEvvvvaaaallllPPPPooooiiiinnnntttt, ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllMMMMaaaatttteeeerrrriiiiaaaallll, and
  103.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaagggg.  Also, it is acceptable to use ffffggggllllCCCCaaaallllllllLLLLiiiisssstttt or ffffggggllllCCCCaaaallllllllLLLLiiiissssttttssss
  104.      to execute display lists that include only the preceding commands.  If
  105.      any other GL command is executed between ffffggggllllBBBBeeeeggggiiiinnnn and ffffggggllllEEEEnnnndddd, the error
  106.      flag is set and the command is ignored.
  107.  
  108.      Regardless of the value chosen for _m_o_d_e, there is no limit to the number
  109.      of vertices that can be defined between ffffggggllllBBBBeeeeggggiiiinnnn and ffffggggllllEEEEnnnndddd.  Lines,
  110.      triangles, quadrilaterals, and polygons that are incompletely specified
  111.      are not drawn.  Incomplete specification results when either too few
  112.      vertices are provided to specify even a single primitive or when an
  113.      incorrect multiple of vertices is specified. The incomplete primitive is
  114.      ignored; the rest are drawn.
  115.  
  116.      The minimum specification of vertices for each primitive is as follows:
  117.      1 for a point, 2 for a line, 3 for a triangle, 4 for a quadrilateral, and
  118.      3 for a polygon.  Modes that require a certain multiple of vertices are
  119.      GGGGLLLL____LLLLIIIINNNNEEEESSSS (2), GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS (3), GGGGLLLL____QQQQUUUUAAAADDDDSSSS (4), and GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP (2).
  120.  
  121. EEEERRRRRRRROOOORRRRSSSS
  122.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is set to an unaccepted value.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ffffggggllllBBBBeeeeggggiiiinnnn((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ffffggggllllBBBBeeeeggggiiiinnnn((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllBBBBeeeeggggiiiinnnn is executed between a
  141.      ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  142.  
  143.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllEEEEnnnndddd is executed without being
  144.      preceded by a ffffggggllllBBBBeeeeggggiiiinnnn.
  145.  
  146.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if a command other than ffffggggllllVVVVeeeerrrrtttteeeexxxx,
  147.      ffffggggllllCCCCoooolllloooorrrr, ffffggggllllIIIInnnnddddeeeexxxx, ffffggggllllNNNNoooorrrrmmmmaaaallll, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd, ffffggggllllEEEEvvvvaaaallllCCCCoooooooorrrrdddd, ffffggggllllEEEEvvvvaaaallllPPPPooooiiiinnnntttt,
  148.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllMMMMaaaatttteeeerrrriiiiaaaallll, ffffggggllllEEEEddddggggeeeeFFFFllllaaaagggg, ffffggggllllCCCCaaaallllllllLLLLiiiisssstttt, or ffffggggllllCCCCaaaallllllllLLLLiiiissssttttssss
  149.      is executed between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding
  150.      execution ffffggggllllEEEEnnnndddd.
  151.  
  152.      Execution of ffffggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee, ffffggggllllDDDDiiiissssaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee,
  153.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr,
  154.      ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr, ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss, or
  155.      ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee is not allowed after a call to ffffggggllllBBBBeeeeggggiiiinnnn and before the
  156.      corresponding call to ffffggggllllEEEEnnnndddd, but an error may or may not be generated.
  157.  
  158.  
  159. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  160.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllCCCCaaaallllllllLLLLiiiisssstttt, ffffggggllllCCCCaaaallllllllLLLLiiiissssttttssss, ffffggggllllCCCCoooolllloooorrrr, ffffggggllllEEEEddddggggeeeeFFFFllllaaaagggg,
  161.      ffffggggllllEEEEvvvvaaaallllCCCCoooooooorrrrdddd, ffffggggllllEEEEvvvvaaaallllPPPPooooiiiinnnntttt, ffffggggllllIIIInnnnddddeeeexxxx, ffffggggllllMMMMaaaatttteeeerrrriiiiaaaallll, ffffggggllllNNNNoooorrrrmmmmaaaallll,
  162.      ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd, ffffggggllllVVVVeeeerrrrtttteeeexxxx
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.